home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / master / slow_shut_down < prev    next >
Text File  |  2001-04-06  |  2KB  |  41 lines
  1. SYNOPSIS
  2.         void slow_shut_down(int minutes)
  3.  
  4. DESCRIPTION
  5.         Schedule a shutdown for the near future. minutes is the
  6.         desired time in minutes till the shutdown:
  7.          six, if just the user reserve has been put into use.
  8.          one, if the (smaller) master reserve has been put into use as
  9.               well.
  10.  
  11.         The interpreter calls this function when it runs low on
  12.         memory. At this time, it has freed its reserve, but since it
  13.         won't last long, the interpreter needs to be shut down. The
  14.         delay is to give the users the opportunity to finish their
  15.         current tasks, but don't take the 'minutes' for granted, just
  16.         deduce the urgency from it.
  17.         It is possible that the driver may reallocate some memory
  18.         after the function has been called, and then run again into a
  19.         low memory situation, calling this function again.
  20.         This function might load an 'Armageddon' object and tell it
  21.         what to do. It is the Armageddon object then which performs
  22.         the shutdown.
  23.  
  24.         Technical: The memory handling of the interpreter includes
  25.         three reserved areas: user, system and master. All three are
  26.         there to insure that the system shuts down gracefully when the
  27.         memory runs out: the user area to give the users time to
  28.         quit normally, the others to enable emergency-logouts when the
  29.         user reserve is used up as well.
  30.         The areas are allocated at start of the interpreter, and
  31.         released when no more memory could be obtained from the host.
  32.         In such a case, one of the remaining areas is freed (so the
  33.         operation can continue a short while) and a garbage collection
  34.         is initiated. If the garbage collection recycles enough memory
  35.         (either true garbage or by the aid of the quota_demon) to
  36.         reallocate the areas, all is fine, else the system shut down
  37.         is invoked by a call to this function.
  38.  
  39. SEE ALSO
  40.         quota_demon(M), notify_shutdown(M), shutdown(E), malloc(D), memory(C)
  41.